.\" Manpage for mypassword.
.\" Contact jamel.belhaj.bettaieb@gmail.com to correct errors or typos.
.TH MYPASSWORD 1 "20 June 2013" "version 1.0" "mypassword manpage"

.SH NAME
mypassword \- Securely store and remember all your passwords.
 
.SH SYNOPSIS
mypassword [OPTION] <account>@<host> [-app <appname> | -db <dbname>]  

.SH DESCRIPTION
mypassword is a Linux shell script that operates from the command line which,
.RS 0
helps you to safely store, display and manage all your passwords in a secure way.
.RE
.PP
The benefits of deploying mypassword include :
.RS 0
- All encrypted passwords are stored in one place (mysql database).
.RS 0
- Passwords are encrypted/decrypted using the best and most secure algorithms based on MyEncryptor java class.
.RS 0
- You have only to remember one single master passphrase to unlock the whole database.
.RE

.SH OPTIONS
.B -a, --add
<account@host> [
.B -app
<appname> | 
.B -db 
<dbname> ] 
.RS
Add new password in encrypted format to database.
.RE
.RS 
Use -db  or -app option to specify the account type (database or appliance).
.RE
.RS 
.B system
is the default account type if no arguments were passed.
.RE
.RS 
account = login name
.RE
.RS 
host = hostname or IP address of server, switch, router,...
.RE

.B -d, --delete
<account@host> [
.B -app
<appname> | 
.B -db 
<dbname> ] 
.RS
Delete encrypted password entree from database.
.RE
.RS 
Use -db  or -app option to specify the account type (database or appliance).
.RE
.RS 
.B system
is the default account type if no arguments were passed.
.RE
.RS 
account = login name
.RE
.RS 
host = hostname or IP address of server, switch, router,...
.RE

.B -e, --encryptor
.RS
About MyEncryptor java class (
.B SEE ALSO
section for more details).
.RE

.B -h, --help
.RS
Print mypassword manpage.
.RE

.B -k, --key
[<account@host>] [
.B -app
<appname> | 
.B -db 
<dbname> ] 
.RS
Update encryption passphrase (key).
.RE
.RS 
Without arguments, this will update  encryption passphrase for all accounts.
.RE
.RS 
Update takes place only for account where old passphrase match.
.RE
.RS
If you forget your old passphrase, you can't update it.
.RE

.B -l, --list [-app|-db|-sys]
.RS
List stored accounts.
.RE
.RS
Use -app, -db or -sys argument to specify the account type to be listed (application, database or system).
.RE
.RS
With no argument, this will list all stored account. 
.RE

.B -o, --option
.RS
Display option brief description.
.RE

.B -p, --password
<account@host> [
.B -app
<appname> | 
.B -db 
<dbname> ] 
.RS
Update specific password.
.RE
.RS 
Use -db  or -app argument to specify the account type (database or appliance).
.RE
.RS 
without any argument, system is the Default account type.
.RE

.B -v, --version
.RS
Display version release.
.RE

.SH EXAMPLE
.B Show system password in clear text
.RS 0
mypassword root@myserver1
.RE

.B Show database password in clear text
.RS 0
mypassword root@mysqlserver1 -db mydatabase
.RE

.B Add new system password in encrypted format
.RS 0
mypassword -a root@myserver2
.RE

.B Add new application password in encrypted format
.RS 0
mypassword -a root@myserver2 -app myapplication
.RE

.B Update root password on myserver1
.RS 0
mypassword -p root@myserver1
.RE

.B Update passphrase for all accounts
.RS 0
mypassword -k
.RE

.SH RELEASE DETAILS
.RS 0
Release name: mypassword 1.0
.RS 0
Release type: public-stable
.RS 0
Release date: June 20, 2013
.RE

.SH BUGS
No known bugs.
.SH REPORTING BUGS
Report mypassword bugs to jamel.belhaj.bettaieb@gmail.com
.SH AUTHOR
JAMEL BELHAJ BETTAIEB (jamel.belhaj.bettaieb@gmail.com)
.SH COPYRIGHT
Copyright © 2012-2013 Jamel Belhaj Bettaieb.
.RS 0
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
.RE
This is free software: you are free to change and redistribute it.
.RS 0
There is NO WARRANTY, to the extent permitted by law.
.RE
.SH SEE ALSO
MyEncryptor is a java class for encrypting and decrypting strings using MD5 and DES algorithm.
.RS 0
Type mypassword -e for more details.
.RE
